>>

''HTML Anchor Links in Tiddlers''

* >>他们在做什么？ * >>我该怎么做？ * >>限制和需要注意的事情 * >>更多示例 * >>使用 HTML 元素的建议 * >>使用目标名称的建议 * >>嵌入时避免重复的 ID * >>样式提示 >> !! 他们在做什么？在 TiddlyWiki 锚点链接可以帮助我们链接到目标点和渲染的条目中的不同段落。它们可以帮助读者流览更长的条目内容。例如，此链接，>>底部, 应该带你到这个条目的底部。下面 "返回顶部" 的链接应该返回给您，返回到此条目的顶部。 >>返回顶部 >> !! 我该怎么做？制作锚点链接只有 2 个步骤。 * 首先，在需要的地方创建目标点（称为一个 '锚点'）。 * 其次，在读者可能需要的地方添加一个链接。就是这样。 ''第 1 步：创建一个 '锚点' （链接目标）'' ``` ``` * 添加一个 <<.attr id>> 属性至任何 HTML5 的标记，并在 '地址' 值之前放置一个 `#`。以下是一些您可以使用的建议标记。 * 将此代码放在目标位置。例如，在条目的底部。 ''第 2 步：创建一个指向目标锚点的链接'' ``` Bottom ``` * 创建一个 `` 链接使用与目标完全相同的 '地址' 值，但其前面有双 `##` 字符。 * 将此代码放在对读者最有帮助的地方。上述示例可适用于 ~TiddlyWiki 中的许多情况，像是此条目顶部的目录。 ''真的这么简单吗？'' 是的，就这么简单。但是... 在 ~TiddlyWikiin 与标准 HTML5 锚点链接和一些特定的 ~TiddlyWiki 限制有一些小的区别。 >>返回顶部

>>限制和需要注意的事情

''步骤 1：'' 创建目标锚点 * 与标准 HTML5 不同，在 ~TiddlyWiki 中，您必须在目标地址值的前面放置单个 `#` 字符，该地址于 <<.attr id>> 属性之后。 * 与标准 HTML5 不同，~TiddlyWiki 锚点链接是区分大小写的。在上面的示例 #Bottom_of_tiddler 可以，但是 #bottom_of_Tiddler 不能。（请注意，示例 1 的 #Bottom_of_tiddler 中，使用的单个 `#` 字符。 * 避免在链接中使用 `%` 字符，因为某些浏览器有一个错误，其中导航到包含 `%` 字符的锚点有时会失败（请参阅下面的警告）。 * >/>避免在链接中使用任何空白 (见下面 > title="点击以转到注释 1。">注释 1). * 在 ~TiddlyWiki 中的每个链接地址应是唯一的。如果嵌入会创建具有相同 <<.attr id >> 属性的多个实例，导航到第一个满足上述条件的实例。为避免这种情况，您可以在 <<.attr id>> 和 <<.attr href>> 属性中，使用 [[qualify 宏|qualify Macro]] 与下面给出的示例样式类似： > >嵌入时避免重复的 ID. ''步骤 2：'' 创建指向目标的链接 * 请记住，<<.attr href>> 值应以''两个'' `#` 字符开始，比目标锚的 <<.attr id >> 值多一。 * 请记住，~TiddlyWiki 锚点链接，区分大小写 ''步骤 3：'' 导航到目标通常，您可以按下链接，~TiddlyWiki 将滚动窗口，以便目标锚点位于窗口顶部，但存在以下几个限制： * 在 ~TiddlyWiki 中，如果条目不在故事河中，或未在侧边栏中显示，则锚点链接无法使用。 * 在 ~TiddlyWiki 中，如果条目在故事河中，或在侧边栏中但锚标记的目标点在页面上不可见，则锚点链接无法使用 (例如，条目被折合或锚点在非显示的 $reveal 小工具内)。 Ctrl + 点击这样的锚点链接，将打开一个新的浏览器窗口/选项卡，并加载基本网页，不会导航到预期的条目。 * 在 ~TiddlyWiki 中，如果控制台 > 外观 > 故事查看设置为 Zoomin（单页查看）和条目不在故事河的顶部（即未显示），则锚点链接无法使用。 * 按下锚点链接时，浏览器的导航历史记录将更新，链接的 href 值将附加到网页的 URL 中。即使控制台 > 设置 > 历史记录导览设置为 "不更新历史记录"，也会发生这种情况"。 <$macrocall $name=.note _=""">>> title="点击返回">1. <<.attr id>> 属性的 [ext[HTML5 规范|https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id]] 提到其值不应包含任何空格。目前 ^^(2020 年 12 月)^^ 一个 <<.attr id>> 值有空白，有时正常工作。但是，它可能并非在所有浏览器中都有效，并且不能保证将来可以正常工作。""" /> <<.warning "某些浏览器可能无法浏览到 ''id'' 值包含一个 `%` 字符后跟着 2 比特数字的锚点目标。这是浏览器中的一个错误，~TiddlyWiki 无法修复。为了安全起见，请避免使用 `%` 字符。">> >>返回顶部

>>更多示例

在每种情况下，目标代码都放置在读者导航到的目标位置，链接代码被放置在帮助读者导航的位置。 ```

我的目标标题

链接到我的目标标题 ``` 这看起来像：

我的目标标题

链接到我的目标标题

```

!! 我的目标段落一个 `

` HTML 标记通常用于定义 HTML 文档中的段落，例如章节、标题、页脚或文档的任何其他段落。

按下此锚点链接将转到：链接到我的目标段落 ``` 这看起来像：

!! 我的目标段落一个 `

` HTML 标记通常用于定义 HTML 文档中的段落，例如章节、标题、页脚或文档的任何其他段落。

按下此锚点链接将转到：链接到我的目标段落

>>回到顶部

>>''使用 HTML 元素的建议''

一个新标题

"""/>|标题可以有 <<.attr id>> 属性| |<<.def section>> |<$text text="""

这是一个新的段落

>>使用目标名称的建议

A New Heading

"""/>|不保证空白在所有浏览器中工作| |<<.def "Avoid: %">> |<$text text="""

这是一个新的段落

>> ''嵌入时避免重复的 ID''

<<.attr id>> 和锚点链接到此标头已作出如下： ``` >>嵌入时避免重复的 ID

>>嵌入时避免重复的 ID

``` ;要对此有效： * <<.attr href>> 和 <<.attr id>> 值使用[[属性的宏调用语法|HTML in WikiText]]，并使用 [[qualify 宏|qualify Macro]] 创建唯一的 <<.attr id>> 值。 * <<.attr id>> 和锚点链接都必须在同一条目中。 * `=` 和 `<<` 之间不得有任何引号字符。 * 目标名称前后的双引号是可选的，但建议使用。 * `>` 字符，两个 `>>` 来关闭 `<` 来关闭 `>>回到顶部

>>''样式提示''

如果您不希望链接看起来像外部链接，请指定 `` 元素的 <<.attr class>> 属性值 <<.def tc-tiddlylink>>，且如果您希望链接也是斜体和粗体，请指定附加类 <<.def "tc-tiddlylink-missing tc-tiddlylink-shadow">> 如下所示： ``` 回到顶部或只是回到 >>提示. ``` 回到顶部或只是回到 >>样式提示. 如果要包含一个 <<.attr id>> 属性到边栏目录中的一个链接，您可以将其包括在列出的条目的 <<.field caption>> 字段，如同以下所显示的： ``` 您的标题 ``` >> >>回到顶部